home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Sound / Utilities / SoundMachine folder / ReadMe next >
Text File  |  1994-04-03  |  12KB  |  166 lines

  1. SoundMachine 2.1
  2. April 1994
  3. Freeware
  4. Copyright © Rod Kennedy, 1993-1994.
  5. ----------------------------------------------------------------------------
  6. Contact:
  7.  
  8. Rod Kennedy                                    rod@faceng.anu.edu.au
  9. Systems Engineering
  10. RSISE, ANU
  11. Canberra ACT 0200
  12. Australia
  13. ----------------------------------------------------------------------------
  14. (Pseudonyms/alternate possible names: AUPlayer, SNDPlayer [taken], GEEKPlayer, UlawPlayer, MuLawPlayer, AlawPlayer, MuPlayandRecord, ...)
  15. ----------------------------------------------------------------------------
  16. Recommended Brief Description:
  17.  
  18. Play and record SND/AU (mu-law, A-law, linear) and AIFF/AIFC (MACE3, MACE6) sound files.   Plethora of buttons during play to change speed, play backwards, loop sounds, switch formats, etc.  No restriction on file size; playing can take place in background.
  19. ----------------------------------------------------------------------------
  20. For Impatient New Users:
  21.  
  22. Use Balloon help (you really only need to use it during the learning phase).
  23. ----------------------------------------------------------------------------
  24. Sound Formats Supported (Play and Record):
  25.  
  26. • Ulaw/Mu-law/µ-law: (SND_FORMAT_MULAW_8)
  27. TalkRadio (Geek of the week), or International Telephony format, i.e., 8Khz at 8 bit mono making 64kbits/s (as defined in CCITT G711), or Sun Sparc station format, or Next format, blah blah.  With SoundMachine you can record in the µ-law format at any sample rate from 4kHz up to 22.3kHz (the mac hardware rate, at least on the older macs).   Stick to the preferred 8kHz rate (default) if exporting a µ-law sound to the Sun platform or you haven't got a clue about what you are doing. 
  28.  
  29. • AIFF/AIFC (none, MACE3 and MACE6 compression supported)
  30. Preferred mac format for big sound sound files; all sound data is in the data fork (no resource fork information). When playing, SoundMachine hunts for the sampled data chunk and plays that and ignores things like the  MIDI chunk.  Since compression schemes such as MACE3 are dynamical in nature (have a state or memory) then playing such a sound backwards causes sound artefacts.  I rely on the Sound Manager to expand (convert) in real time rather than do the conversion manually (whereby I could cleanup the backward playing).  Stereo play supported.  When recording (mono and 8 bits), the sample rate is the hardware rate of 22.3kHz but you can select from the three standard compression schemes.   MACE3 is recommended for the 8 bit mac platform since it outperforms µ-law which is memoryless and designed for speech.  
  31.  
  32. • Alaw: (SND_FORMAT_ALAW_8)
  33. This is roughly speaking the European equivalent of µ-law.  Everything is the same as for the µ-law description above (just replace µ with A and Bob's your uncle). Play and record facility.
  34.  
  35. • Linear 8 bit 2's complement: (SND_FORMAT_LINEAR_8)
  36. Just like µ-law and A-law this is another one of the SND/AU formats.  SoundMachine supports play and record.  
  37.  
  38. • FSSD non-compressed (play only)
  39. For example, the sound format supplied with Sound Source's Star Trek.  There is a Huffman endoded FSSD format but I don't have enough info about it yet to support it.  SoundMachine relies on information in the resource fork to determine the sample rate.
  40. Data is offset binary 8 bit mono (just like 'snd ' resource format).
  41.  
  42. • Other 8 bit formats (override any header)
  43. You can switch to 2's complement or offset binary representation, µ-law, A-law to hear if an unknown sound type is in one of the formats above.
  44. ----------------------------------------------------------------------------
  45. Environment:
  46.  
  47. Needs System 7.  Can use the Speech Manager if present.  Currently requires a 68020 or better.  I recommend that you use the new Sound Manager 3.0.  Really needs the Apple Sound Chip or better (AV) to work.
  48. ----------------------------------------------------------------------------
  49. Technical Aspects:
  50.  
  51. • µ-law recording is generated indirectly and not in real time (however, the conversion can be put in the background).  SoundMachine records to an uncompressed AIFF 22.3kHz file; applies an approximate ideal low pass, digital, antialias filter (approximate delayed truncated sinc impulse response filter) then linearly interpolates and resamples to the user specified sample rate (which is twice the cut-off frequency of the low pass filter).  The AIFF linear data is overwritten by µ-law converted data and the file is truncated if necessary; and finally the AIFF header is overwritten with a SND/AU header.]
  52.  
  53. • Uses a custom double buffering technique to play arbitrarily large files continuously from disk.  It relies on other applications being multitasking friendly to give a continuous sound output.  SoundMachine does not prime its buffers at interrupt time.
  54.  
  55. • The size of the buffers it allocates depends on the application memory size; increase this if you think there is a problem with the quality of the sound (especially if use use very high sampling rates, e.g., 44.1kHz (CD) or 48.0kHz (DAT)).  The very minimum application size is 256K and is suitable for most 8kHz µ-law sounds.
  56.  
  57. • Be very wary about using the high quality Speech Manager voices as they are system memory hogs.  If your memory is limited you should consider using Mr Hughes or Boris (best of the robotic voices) or disabling the voices altogether using the preferences file.
  58.  
  59. • This is not intended to be a sound format converter (that task is straightforward but very painful to implement, see "SOX") but rather a player for the most common (mac-orientated) SAMPLED SOUND sound formats (let's face it, primarily 8 bit µ-law).
  60. ----------------------------------------------------------------------------
  61. Controls:
  62.  
  63. Sounds can be fastforwarded; reversed and sped-up; paused and looped.  Clicking  within the progress bar skips to that portion of the sound.  There are some keyboard equivalents like:
  64.  • g (go) meaning play
  65.  • p (pause)
  66.  • f (fast forward)
  67.  • b (backwards)
  68.  • <right arrow> next file in queue
  69.  • <left arrow> previous file in queue
  70.  • <down arrow> volume down (unrelated to the control panel setting; A and µ-law only)
  71.  • <up arrow> volume up
  72.  • s (stop)
  73.  • l (loop)
  74.  • u (uh?) sound format change
  75.  • i (information) cycle through the information fields
  76.  • command period
  77. If you forget just use balloon help.
  78. ----------------------------------------------------------------------------
  79. Additional Features: 
  80.  
  81. Any number of files (max 100) can be dragged and dropped onto the application icon and SoundMachine will queue and (try to) play every file.  For help on how to drive SoundMachine use Balloon Help.  If there is no data in the data fork of the file, then the file is just skipped (with a warning alert).
  82.  
  83. The preferences are kept in a file called "SoundMachine Prefs" (this is different from
  84. previous versions of SoundMachine which used "SoundMachine Preferences"; this older preferences file should be discarded since the data is in a slightly different format; no harm will come if you don't discard it).
  85. ----------------------------------------------------------------------------
  86. Future Things to do:
  87.  
  88. 1. ADPCM formats.
  89. 2. Sound level display.
  90. 3. 'snd ' resource playing capability.
  91. 4. Play text files using the Speech voice.
  92. 5. 16 bit sound.
  93. 6. Greater than 2 channel (stereo) support.
  94. ----------------------------------------------------------------------------
  95. Bugs:
  96.  
  97. Please report any bugs or info on any other sound format you want supported (no promises).  With bugs try and describe a precisely as possible the nature of the problem.  Also forward a binhexed version of the sound file if you think this might be the problem.
  98. ----------------------------------------------------------------------------
  99. Disclaimer:
  100.  
  101. SoundMachine is freeware.  I retain the copyright, including the right to alter or sell the program.  You may use and copy SoundMachine freely only on a non-commercial basis.  SoundMachine cannot be distributed with any commercial package without my permission.   An exception is that SoundMachine may be included on any CD ROM provided I get a free copy of that CD ROM (this applies also to any updates of SoundMachine that are later included on any CD ROM).  You may not alter or sell this program without my permission.  This ReadMe file must accompany SoundMachine.
  102. ----------------------------------------------------------------------------
  103. Acknowledgements:
  104.  
  105. Many thanks to a bunch of Northern Hemispherian beta testers.
  106. ----------------------------------------------------------------------------
  107. Obscure Stuff:
  108.  
  109. unsigned char UlawToSnd[] = // x1 (default)
  110. {
  111.   3,  7, 11, 15, 19, 23, 27, 31, 35, 39, 43, 47, 51, 55, 59, 63,
  112.  66, 68, 70, 72, 74, 76, 78, 80, 82, 84, 86, 88, 90, 92, 94, 96,
  113.  98, 99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,
  114. 113,114,114,115,115,116,116,117,117,118,118,119,119,120,120,121,
  115. 121,121,122,122,122,122,123,123,123,123,124,124,124,124,125,125,
  116. 125,125,125,125,126,126,126,126,126,126,126,126,127,127,127,127,
  117. 127,127,127,127,127,127,127,127,128,128,128,128,128,128,128,128,
  118. 128,128,128,128,128,128,128,128,128,128,128,128,128,128,128,128,
  119. 253,249,245,241,237,233,229,225,221,217,213,209,205,201,197,193,
  120. 190,188,186,184,182,180,178,176,174,172,170,168,166,164,162,160,
  121. 158,157,156,155,154,153,152,151,150,149,148,147,146,145,144,143,
  122. 143,142,142,141,141,140,140,139,139,138,138,137,137,136,136,135,
  123. 135,135,134,134,134,134,133,133,133,133,132,132,132,132,131,131,
  124. 131,131,131,131,130,130,130,130,130,130,130,130,129,129,129,129,
  125. 129,129,129,129,129,129,129,129,128,128,128,128,128,128,128,128,
  126. 128,128,128,128,128,128,128,128,128,128,128,128,128,128,128,128
  127. };
  128.  
  129. This table is actually not the best conversion possible if higher quality sound is desired.  After conversion of a µ-law number to a 16 bit linear number, SoundMachine has a facility to scale this number and extract the any 8 bits (with saturation) to send to the sound channel (after lookup table conversion).
  130. ----------------------------------------------------------------------------
  131. SND FORMAT ENCODING NUMBERS
  132.  
  133. Currently SoundMachine supports numbers 1, 2 and 27
  134.  
  135. The intention is to support also 3 and 23 to 26; most of the rest are insane.
  136.  
  137. 0       SND_FORMAT_UNSPECIFIED  unspecified format 
  138. 1       SND_FORMAT_MULAW_8      8-bit mu-law samples
  139. 2       SND_FORMAT_LINEAR_8     8-bit linear samples
  140. 3       SND_FORMAT_LINEAR_16    16-bit linear samples
  141. 4       SND_FORMAT_LINEAR_24    24-bit linear samples
  142. 5       SND_FORMAT_LINEAR_32    32-bit linear samples
  143. 6       SND_FORMAT_FLOAT        floating-point samples
  144. 7       SND_FORMAT_DOUBLE       double-precision float samples
  145. 8       SND_FORMAT_INDIRECT     fragmented sampled data
  146. 9       SND_FORMAT_NESTED       ?
  147. 10      SND_FORMAT_DSP_CORE     DSP program
  148. 11      SND_FORMAT_DSP_DATA_8   8-bit fixed-point samples
  149. 12      SND_FORMAT_DSP_DATA_16  16-bit fixed-point samples
  150. 13      SND_FORMAT_DSP_DATA_24  24-bit fixed-point samples
  151. 14      SND_FORMAT_DSP_DATA_32  32-bit fixed-point samples
  152. 15      ?
  153. 16      SND_FORMAT_DISPLAY      non-audio display data
  154. 17      SND_FORMAT_MULAW_SQUELCH        ?
  155. 18      SND_FORMAT_EMPHASIZED   16-bit linear with emphasis
  156. 19      SND_FORMAT_COMPRESSED   16-bit linear with compression
  157. 20      SND_FORMAT_COMPRESSED_EMPHASIZED        A combination of the two above
  158. 21      SND_FORMAT_DSP_COMMANDS Music Kit DSP commands
  159. 22      SND_FORMAT_DSP_COMMANDS_SAMPLES         ?
  160. 23      SND_FORMAT_ADPCM_G721
  161. 24      SND_FORMAT_ADPCM_G722
  162. 25      SND_FORMAT_ADPCM_G723_3
  163. 26      SND_FORMAT_ADPCM_G723_5
  164. 27      SND_FORMAT_ALAW_8
  165.  
  166.